home *** CD-ROM | disk | FTP | other *** search
/ Zoom 2 / Zoom - Release 2 (1996)(Active Software)[!].iso / music / utilities / magicmod / magicmod.doc < prev    next >
Text File  |  1995-11-08  |  4KB  |  99 lines

  1.   MagicMOD © 1995 by David C. May.  All Rights Reserved.
  2. ----------------------------------------------------------
  3.  
  4. MagicMOD plays a ST/NT/PT MOD using the PTReplay.library
  5. by Mattias Karlsson.  For this reason, you must move the
  6. PTREPLAY.LIBRARY file to LIBS: before attempting to run
  7. MagicMOD.  Once it is started, a window opens with five
  8. gadgets to control the playback of the MOD:
  9.  
  10.  Load Mod   (disk) Opens an ASL file requester to load a
  11.                    new MOD.  In jukebox mode, selects a
  12.                    new MOD from the MOD path at random.
  13.  Restart      |<   Stops a MOD and returns its play
  14.                    position to the beginning.  Allows
  15.                    other MagicMOD and MOD players to use
  16.                    the audio channels.
  17.  Pause        []   Stops a MOD at its current position.
  18.  Play         ->   Begins playing a MOD or continues play
  19.                    of a MOD from its current position.
  20.  Rewind       <<   Moves play position back one pattern.
  21.  Fast Forward >>   Moves play position forward one
  22.                    pattern.
  23.  
  24. Close the window to exit.
  25.  
  26. When run as a Workbench tool, MagicMOD will play one
  27. selected project icon.  This can be done by clicking the
  28. MagicMOD icon, holding shift, and double-clicking on a
  29. MOD's project icon.  You can also set the default tool of
  30. the MOD's project icon to MagicMOD's pathname, then
  31. double-clicking on the icon.  If you double-click only on
  32. the MagicMOD icon, an ASL file requester will appear,
  33. prompting you for a MOD's pathname.
  34.  
  35. Tooltypes read when run as a Workbench tool:
  36.  
  37.   FULLPLAY       - Play once, no loop, fewer control
  38.                     buttons.
  39.   SCREEN=<name>  - Open on public screen <name>.
  40.   MINIMIZE       - Open as titlebar window.
  41.   MODPATH=<path> - Default MOD path (for ASL req.)
  42.     JUKEBOX        - Play random MODs from the MOD path.
  43.                    Overrides MOD selection.
  44.  
  45. To run MagicMOD from the Shell, type:
  46.  
  47.   MagicMOD [<MOD File>] [FULLPLAY] [SCREEN PubScreenName]
  48.        [MINIMIZE] [MODPATH <MOD Path>] [JUKEBOX] [?]
  49.  
  50.     <MOD File> - If specified, MagicMOD will play the
  51.                  MOD.  If not specified, an ASL file
  52.                  requester will prompt you for a MOD's
  53.                  pathname, using the optional MODPATH
  54.                  parameter as the default path.
  55.  
  56.     FULLPLAY   - If specified, the MOD will be played
  57.                  through once and will not loop.  Also,
  58.                  the MagicMOD window will open with no
  59.                  load gadget.  This option is useful if
  60.                  you have a directory with several MODs,
  61.                  for which you may type:
  62.  
  63.   execute spat MagicMOD <MOD File Pattern> FULLPLAY
  64.  
  65.                  and have each MOD that matches the
  66.                  pattern played.
  67.  
  68.     SCREEN     - If used, the MagicMOD window will open
  69.                  on the public screen given.
  70.  
  71.     MINIMIZE   - If used, the window opened will be the
  72.                  size of its title bar.
  73.  
  74.     MODPATH    - Use this to specify a MOD path when no
  75.                  MOD is given or the MOD given cannot
  76.                  load. (for ASL req.)
  77.  
  78.     JUKEBOX    - Plays MODs from the MOD path at random.
  79.                  The disk icon then selects new MODs at
  80.                  random.  Overrides MOD selection.
  81.  
  82.     ?          - Displays the command template for
  83.                  MagicMOD.
  84.  
  85. This program is free of charge, and the PTReplay.library
  86. is distributed free of charge.  You are urged to support
  87. the author if you enjoy this program by sending £3 UK or
  88. $5 US (cash or check) to:
  89.  
  90.   David C. May
  91.   1931 West 5745 North
  92.   St. George, UT 84770-5959
  93.   USA
  94.  
  95. The author can also be reached by Email at:
  96.  
  97.   may_d@cc.dixie.edu
  98.  
  99. Enjoy!